Interaction Property Types
The
property
parameter of the
QTVRGetInteractionProperty
and
QTVRSetInteractionProperty
functions specifies a type of user interaction property. For any specific property type, the
value
parameter specifies its current or desired value. These constants define the available interaction property types:
enum {
kQTVRInteractionMouseClickHysteresis = 1,
kQTVRInteractionMouseClickTimeout = 2,
kQTVRInteractionPanTiltSpeed = 3,
kQTVRInteractionZoomSpeed = 4,
kQTVRInteractionTranslateOnMouseDown = 101,
kQTVRInteractionMouseMotionScale = 102,
kQTVRInteractionNudgeMode = 103
};
#define kQTVRInteractionDefaultValue 0x80000000
You can get or set the default value of any of the interaction values by performing a bitwise OR of the property constant with
k
QTVR
InteractionDefaultValue
and pasting the result into the
property
parameter.
Constant descriptions
-
k
QTVR
InteractionMouseClickHysteresis
-
The
value
parameter is interpreted as an unsigned short integer that represents the
mouse-click hysteresis,
the distance, in pixels, from the location of a mouse-down event to the limit within which the cursor is considered not to have moved. In other words, the cursor can move that many pixels during a mouse click and still have the event considered a click. The default mouse-click hysteresis value is 2. This property is valid for panoramas only.
-
k
QTVR
InteractionMouseClickTimeout
-
The
value
parameter is interpreted as an unsigned long integer that represents the
mouse-click timeout,
the number of ticks after which a mouse click times out and is automatically switched from a hot spot selection into a pan. The default mouse-click timeout value is 30 ticks (one-half second). This property is valid for panoramas only.
-
kQTVRInteractionPanTiltSpeed
-
The panning and tilting speed. The
value
parameter is interpreted as an unsigned long integer that represents the relative speed of panning and tilting. This integer should be from 1 (the slowest speed) through 10 (the fastest speed); the default panning and tilting speed is 5. This property is valid only for panoramas.
-
kQTVRInteractionZoomSpeed
-
The
value
parameter is interpreted as an unsigned long integer that represents the
zooming speed,
the relative speed of zooming in and out. This integer should be from 1 (the slowest speed) through 10 (the fastest speed); the default zooming speed is 5. This property is valid for both objects and panoramas.
-
kQTVRInteractionTranslateOnMouseDown
-
The translate flag. The
value
parameter is interpreted as a Boolean value that indicates whether translate mode is enabled (
true
) or disabled (
false
). When
translate mode
is enabled, the user can no longer pan or tilt using the mouse; instead, dragging the cursor causes the object to translate. The default translate flag value is
false
. This property is valid for objects only.
-
kQTVRInteractionMouseMotionScale
-
The
value
parameter is interpreted as a pointer to a floating-point number that represents the
mouse-motion scale,
the number of degrees or radians that an object or panorama is panned or tilted when the cursor is dragged the entire width of the object bounding box. The default value is 180.0. This property is valid for objects only.
-
kQTVRInteractionNudgeMode
-
This parameter lets you set the QuickTime VR nudge mode to either rotate, translate, or be the same as the current mouse mode. See
"Nudge Mode"
.
© 1998 Apple Computer, Inc.| Previous | Chapter Contents | Chapter Top | Next |
